home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 11
/
Cream of the Crop 11-1.iso
/
comm
/
slip_mud.zip
/
MUDCAL23.DOC
< prev
next >
Wrap
Text File
|
1995-12-15
|
11KB
|
236 lines
MudCaller v2.30
Copyright 1993 - Peter Haight
Documentation
I. Brief Overview
------------------------------
Mudcaller is a Telnet client that has been specificaly modified to make
working with MUDs easier and quicker. Mudcaller uses Turbo Vision to provide
a simple, graphical windowing environment to enhance MUD playing. MudCaller
works on an Ethernet network that uses the Crynwr Packet Drivers. MudCaller
will NOT work with a modem unless the modem is connected via SLIP with
Crynwr Packet Drivers.
Mudcaller now uses a TCP driver devloped by Peter Tattam which not only
provides multiple TCP/IP/UDP sessions, but also is much faster than many of
the other TCP drivers available. This driver enables Mudcaller to call more
than one MUD simultaneously. More information on this TCP TSR is available
in the file ntcpdrv.doc.
This program is free of charge for anyone who wishes to use it. I would
like people who do use it to drop me a line via email at psh1@cornell.edu and
let me know that they are using it and whether they like it or not. This
program may be distributed freely as long as no charge is asked for it use.
II. Features (v2.30)
------------------------------
- Multiple MUD sessions
- Large scrollback buffer
- 26 User-defineable Macros
- 50 User-defineable Responses
- Word Wrap
- Logging
- 'Barebones' telnet support.
III. Installation
------------------------------
Because of the new TCP driver Mudcaller has a much different installation
procedure than the last version. In order for Mudcaller to work, this is
what has to happen:
1. Load up Crynwr packet driver (ie. 3c503.com)
2. Load up TCP driver (ie. NTCPDRV.EXE)
3. Run Mudcaller
4. Unload TCP driver. (The TCP driver may interfere with other network
programs, so you have to unload it when you are done).
In order to facilitate this, I have provide a small installation program
which will create three batch files for you which make it much easier to run
MUDCaller:
The first one will be called TCPLOAD.BAT and will be put in the same
directory as NTCPDRV.EXE. This batch file loads the TCP driver with your
configuration.
The second one will be called TCPUNLOAD.BAT and will also be put in the
same directory as NTCPDRV.EXE. This batch file UNLOADS the TCP driver.
The third batch will be called MUDCAL.BAT and will be put in the
directory from which INSTALL.EXE is run. MUDCAL.BAT calls TCPLOAD.BAT,
then it runs MudCaller, then, when you are done, calls TCPUNLOAD.BAT.
The reason for the three batch files is that if you run other programs
that use the NTCPDRV (like I do) you often want to call TCPLOAD.BAT and
TCPUNLOAD.BAT for other programs. This makes it very easy.
In order to create these files, the installer program needs some information:
1. It needs a path to the NTCPDRV.EXE file. This can be wherever you
want. On my system I have it in c:\tcp\
2. It needs to know whether your system uses BootP or not. BootP is a
type of Network option that dynamically allocates your IP address and
also provides you with information about your network like your
Gateway IP address, your DNS server, your IP address, etc...
If you don't know whether you have BootP or not, ask the person who
hooked you up to the network (ie. you system administrator).
You probably don't have BootP if you already know your IP Address,
gateway, and DNS server.
3. If you don't have BootP then the installer will ask you for your
IP Address, Gateway IP Address, DNS IP Address, and Subnet Mask.
You should already know these. If you don't you need to ask your
system administrator what these are. They are all of the form:
(X.X.X.X) where X is a number from 1 to 255.
4. The installer will now create your batch files. All you need to
do now is make sure that your Crynwr Packet Driver is installed.
IV. Using MUDCaller
------------------------------
Mudcaller is simple to use once it is loaded up (I hope). To call a mud
just pull down the menu File and pick Open, or hit F3. When you do this a
dialog box will pop up which will show you a list of all the MUDS you have
entered. If there are no MUDS entered hit the Add button to add a MUD.
Now you have to enter three things:
- The name for this MUD (whatever you want to call it).
- Either its machine name or its IP address.
- Its port address.
Once you have these entered, press OK to save them.
Now you will be back at the Open Dialog box. Now just pick a MUD from the
list and press OK. Mudcaller will now try to call the MUD. Sometimes if the
MUD is busy or it is not responding Mudcaller will look like it is sitting
there for awhile. It should eventually open a window or give you an error
message.
Once a window is open, you can type in the bottom part of the window to
send stuff to the MUD and everything that the MUD sends is in the top part
of the window.
You can open another session, but choosing File and then Open again or
by pressing F3.
V. How to use Features
------------------------------
1. Macros
Right now, Mudcaller can use 26 Macros from Alt-A to Alt-Z.
(Though, Alt-X will exit the program right now, so don't use it).
To use a macro, you have to edit the MACROS.DAT file that comes
with Mudcaller. You can use EDIT which comes with DOS 5.0 to edit
this file.
Each line in the file is a MACRO and has the form:
Alt-?,<string>
where the ? is a letter from A to Z and the string is whatever you
want to send to the MUD. If the string contains a | then it will
send a <CR> or <enter> to the MUD.
For example:
Alt-M,n|n|kill squirrel|
Would be the equivalent of typing:
n<enter>
n<enter>
kill squirrel<enter>
2. Reponses
These work in much the same way as Macros. These are in a file
that comes with Mudcaller called RESPONSE.DAT.
You need to edit this file to make your own responses. The
form for a response is:
<string>,,<string>
Where the first string is the string that Mudcaller looks for and
the second string is the string that Mudcaller will send.
Again, a | signifies <enter> to Mudcaller. Note: putting a | in the
first string will just have it look for a |, there is no way right
now to make it look for an <enter>.
For example:
dogcow,,examine dogcow|
would send:
examine dogcow<enter>
to the MUD whenver it sees the word dogcow come from the mud. Note:
it is case sensitive.
You can make your own auto-login with this by using this response:
name:,,Thist|
Password:,,Lec4ro84a|
3. Logging
To turn Logging on, press F8 and give it a file name. To turn it
off, press F8 again. There is no indicator whether logging is on for
a given window yet. If you hit F8 and you are asked for a file name
then logging was off. Otherwise it was on.
Also, if you have multiple windows open and you hit F8 then it will
log the window you have selected. You can log each window into
seperate files.
VI. About the Packet Drivers.
------------------------------
- This program uses two other programs to access the internet.
Crynwr Packet Driver
The lowest layer is the Crynwr packet driver. This layer directly
interfaces with either the specific ethernet card that you use or the
modem that you are using for SLIP. You need to have the specific
Crynwr driver for your card in order for Mudcaller to work. You
can either get the drivers from the internet or perhaps your the
manufacturer of your card provides one. Look at the file "howtoget.it"
for more instructions.
Peter Tattam's TCP driver
The next layer is Peter Tattam's TCP driver. This uses the Crynwr
packet driver and provides an easy method for programmers to use the
TCP/IP suite as well as providing a nice method for multiple
connections. The version that comes with this program will work with
any Crynwr packet driver including the slip driver SLIP8250 and
Peter Tattam's own CSLIPPER.
VII. History
------------------------------
v2.30 - Fixed cursor problems.
- Fixed string length problem. Max length of string is now infinite.
v2.10 - Fixed freezing problem.
- Added word wrap to windows.
- Fixed problem with Add Server
v2.00 - Fixed <CR> <LF> problem with MUSHES
- Added Multiple sessions
- Added Responses
- Added Macros
- Added password protection
- Fixed description cutoffs that happened with some MUDS.
- Changed MUD window
- Changed driver to Peter Tattam's driver.
VIII. Known Bugs
------------------------------
v2.30 - Delete Server has not been implemented yet.
- On some muds if they have a line that is about 78 characters with a
CR at the end, Mudcaller sometimes wraps it so that one word will
appear on the next line.
- Full telnet support is shakey. It DOES NOT act as a vt100 terminal. In
fact it doesn't have any terminal emulation which doesn't make it very
nice when just connected to a unix host. Next version may have vt100
support.
X. Extra Info.
------------------------------
I am very intersted in hearing your comments about the program. Please let
me know what you think can be improved, added, and/or fixed. My e-mail
address is psh1@cornell.edu.
I'd also like it if you would drop me a line if you use my program, just so
I can get an idea of how many people use it.
Please also feel free to write me if you have problems getting the program
to run on your system.
IV. DISCLAIMER AND WARNINGS
------------------------------
DISCLAIMER
There is no warranty or promise provided with this software. Peter Haight
is not responsible for any damage that may occur as a result of using this
program. YOU USE THIS PROGRAM AT YOUR OWN RISK.
YOU MAY NOT modify or sell MudCaller for any reason without the express
permission of Peter Haight.
This software is Copyright 1993 by RIH Productions and Peter Haight.